home *** CD-ROM | disk | FTP | other *** search
ssssttttrrrrttttoooodddd((((3333CCCC)))) ssssttttrrrrttttoooodddd((((3333CCCC)))) NNNNAAAAMMMMEEEE _ssss_tttt_rrrr_tttt_oooo_dddd, _aaaa_tttt_oooo_ffff, _ssss_tttt_rrrr_tttt_oooo_llll_dddd, _aaaa_tttt_oooo_llll_dddd - convert string to double-precision or long double-precision number SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_tttt_dddd_llll_iiii_bbbb_...._hhhh_>>>> _dddd_oooo_uuuu_bbbb_llll_eeee _ssss_tttt_rrrr_tttt_oooo_dddd _((((_cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_nnnn_pppp_tttt_rrrr_,,,, _cccc_hhhh_aaaa_rrrr _****_****_eeee_nnnn_dddd_pppp_tttt_rrrr_))))_;;;; _dddd_oooo_uuuu_bbbb_llll_eeee _aaaa_tttt_oooo_ffff _((((_cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_nnnn_pppp_tttt_rrrr_))))_;;;; _llll_oooo_nnnn_gggg _dddd_oooo_uuuu_bbbb_llll_eeee _ssss_tttt_rrrr_tttt_oooo_llll_dddd _((((_cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_nnnn_pppp_tttt_rrrr_,,,, _cccc_hhhh_aaaa_rrrr _****_****_eeee_nnnn_dddd_pppp_tttt_rrrr_))))_;;;; _llll_oooo_nnnn_gggg _dddd_oooo_uuuu_bbbb_llll_eeee _aaaa_tttt_oooo_llll_dddd _((((_cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_nnnn_pppp_tttt_rrrr_))))_;;;; DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN (Note that the long double routines are only valid for the MIPSpro compilers.) _ssss_tttt_rrrr_tttt_oooo_dddd returns as a double-precision floating-point number the value represented by the character string pointed to by _n_p_t_r. Similarly, _ssss_tttt_rrrr_tttt_oooo_llll_dddd returns as a long double-precision floating-point number the value represented by the character string pointed to by _n_p_t_r. Each function scans the string up to the first unrecognized character. _ssss_tttt_rrrr_tttt_oooo_dddd and _ssss_tttt_rrrr_tttt_oooo_llll_dddd recognize an optional string of ``white-space'' characters [as defined by _iiii_ssss_ssss_pppp_aaaa_cccc_eeee in _cccc_tttt_yyyy_pppp_eeee(3C)], then an optional sign, then a string of digits optionally containing a decimal-point character [as specified by the current locale; see _ssss_eeee_tttt_llll_oooo_cccc_aaaa_llll_eeee(3C)], then an optional exponent part including an _eeee or _EEEE followed by an optional sign, followed by an integer. If the value of _e_n_d_p_t_r is not _((((_cccc_hhhh_aaaa_rrrr _****_****_))))_NNNN_UUUU_LLLL_LLLL, a pointer to the character terminating the scan is returned in the location pointed to by _e_n_d_p_t_r. If no number can be formed, *_e_n_d_p_t_r is set to _n_p_t_r, and zero is returned. _aaaa_tttt_oooo_ffff_((((_nnnn_pppp_tttt_rrrr_)))) is equivalent to: _ssss_tttt_rrrr_tttt_oooo_dddd_((((_nnnn_pppp_tttt_rrrr_,,,, _((((_cccc_hhhh_aaaa_rrrr _****_****_))))_NNNN_UUUU_LLLL_LLLL_)))). _aaaa_tttt_oooo_llll_dddd_((((_nnnn_pppp_tttt_rrrr_)))) is equivalent to: _ssss_tttt_rrrr_tttt_oooo_llll_dddd_((((_nnnn_pppp_tttt_rrrr_,,,, _((((_cccc_hhhh_aaaa_rrrr _****_****_))))_NNNN_UUUU_LLLL_LLLL_)))). SSSSEEEEEEEE AAAALLLLSSSSOOOO _cccc_tttt_yyyy_pppp_eeee(3C), _ssss_tttt_rrrr_tttt_oooo_llll(3C), _ssss_cccc_aaaa_nnnn_ffff(3S). NNNNOOOOTTTTEEEE Precision may be silently lost if the number of digits comprising the floating-point number (i.e., not including the exponent) exceeds the value of the constant DBL_DIG (LDBL_DIG) in _<<<<_ffff_llll_oooo_aaaa_tttt_...._hhhh_>>>>. PPPPaaaaggggeeee 1111 ssssttttrrrrttttoooodddd((((3333CCCC)))) ssssttttrrrrttttoooodddd((((3333CCCC)))) As of IRIX 6.5.18, these functions accept hex strings of the form _0000_xxxx_1111_...._xxxx_xxxx_xxxx_pppp_nnnn_nnnn, which are floating point constants. A floating constant has a significand part that can be followed by an exponent part and a suffix that specifies its type. The significand may include a digit sequence that represents the whole-number part, followed by a period, followed by a digit sequence that represents the fraction part. The exponent part is composed of _eeee, _EEEE, _pppp, or _PPPP followed by an exponent that may contain an optionally signed digit sequence. Either the whole number part or the fraction part must be present; for decimal floating constants, either the period or the exponent part has to be present. Example: _0000_xxxx_1111_...._ffff_ffff_ffff_pppp_++++_1111_0000. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS If the correct value would cause overflow, _++++_////_----_HHHH_UUUU_GGGG_EEEE______VVVV_AAAA_LLLL is returned (according to the sign of the value), and _eeee_rrrr_rrrr_nnnn_oooo is set to _EEEE_RRRR_AAAA_NNNN_GGGG_EEEE. If the correct value would cause underflow, zero is returned and _eeee_rrrr_rrrr_nnnn_oooo is set to _EEEE_RRRR_AAAA_NNNN_GGGG_EEEE. PPPPaaaaggggeeee 2222 
